package edu.ccut.saturn.component;

import java.sql.Connection;
import java.util.List;

/**
 * Deposit a component execute() method parameter context.
 * <p>
 * include:
 * <li>1. parameter List.
 * <li>2. Exception
 * <li>3. TODO: something more?
 * 
 * @author 谷钰
 * @version 1.0 2008.9.09
 * 
 */
public interface IParameterContext {

	/**
	 * Get parameter List
	 * 
	 * @return
	 */
	public List<IParameter> getParameters();

	/**
	 * Get No. i parameter
	 * 
	 * @param i
	 * @return
	 */
	public IParameter getParameter(int i);

	/**
	 * Get No. i parameter value
	 * 
	 * @param i
	 * @return
	 */
	public Object getParameterValue(int i);

	/**
	 * Set No. i parameter value
	 * 
	 * @param i
	 * @param value
	 */
	public void setParameter(int i, Object value);

	/**
	 * Add a {@link IParameter}
	 * 
	 * @param value
	 * @param classType
	 */
	public void addParameter(Object value, Class<?> classType);
	
	/**
	 * 获得数据库连接对象
	 * @return
	 */
	public Connection getConnection();
	/**
	 * Set A Exception
	 * 
	 * @param throwable
	 */
	public void setException(Throwable throwable);

	/**
	 * Get Exception information
	 * 
	 * @return
	 */
	public Throwable getException();
	
	/**
	 * 获得事务类型信息
	 * @return
	 */
	public String getTransactionType();
	
	/**
	 * 判断参数上下文对象中是否维护了数据库连接对象
	 * @return
	 */
	public boolean hasConnection();
	
	/**
	 * 获得logic上下文中的数据
	 * @param key
	 * @return
	 */
	public Object getLogicContextValue(String key);
	

	public ILogicContext getLogicContext();

	public void setLogicContext(ILogicContext logicContext);
	
	public IParameterContext newParameterContext();
}
